home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-05 / lanmodm1.zip / TESTNET.DOC < prev    next >
Text File  |  1989-11-15  |  15KB  |  397 lines
  1.                                     TESTNET
  2.                       Utility for Testing NetBIOS Networks
  3.                                November 13, 1989
  4.                            CROSS Information Company
  5.  
  6.           Forward.
  7.           Several NetBIOS networks are not very stable and do not
  8.           provide a correct NetBIOS emulation. This utility will allow
  9.           one to test the network to verify that MCOM, UCOM, and
  10.           NETDEV will operate correctly within the network environ-
  11.           ment. Using this utility, one can simulate modem I/O over-
  12.           night to verify that the network will not "hang up" on the
  13.           procedure and that the systems involved will not crash.
  14.  
  15.           Using TESTNET.
  16.           Find some workstation on your system that has a communica-
  17.           tions adapter port (COM port). You must use a COM port even
  18.           though you normally intend to use internal modems. Verify
  19.           that the COM port operates correctly by using any ordinary
  20.           "smart-terminal" program to access the port. You can do this
  21.           by connecting a lead between the RS-232C terminals 2 and 3.
  22.           This connects the transmit and receive leads together. When
  23.           you type something on the keyboard, it should immediately
  24.           echo on the screen. If your "smart-terminal" program does
  25.           not echo characters, it probably means that the IRQ (inter-
  26.           rupt request) lines are not enabled on the communications
  27.           adapter card. Verify that COM1 uses IRQ4 and COM2 use IRQ3.
  28.           After you have your communications adapter port operating
  29.           correctly, leave the jumper between terminals 2 and 3 of the
  30.           RS-232C connector and then load MCOM on the workstation.
  31.  
  32.           Using any other workstation on your system, execute TESTNET.
  33.           The program should find the "COMM01" device and begin to do
  34.           I/O with the MCOM device-driver.
  35.  
  36.           ╔═════════════════════════════════════════════════╗
  37.           ║ TESTNET  NetBIOS Network Testing Utility  V1.01 ║
  38.           ║  Copyright (c) 1989  Cross Information Company  ║░░░
  39.           ║   All rights reserved worldwide.   Ser  12345   ║░░░
  40.           ║   Phone (303) 444-7799    FAX (303) 444-4687    ║░░░
  41.           ║                                                 ║░░░
  42.           ║   Check network : Okay                          ║░░░
  43.           ║        Add name : Okay                          ║░░░
  44.           ║       Call name : Okay                          ║░░░
  45.           ║       Send data : Okay                          ║░░░
  46.           ║    Receive data : Okay                          ║░░░
  47.           ║      Check data : Okay                          ║░░░
  48.           ║   Send datagram : Okay                          ║░░░
  49.           ║   Recv datagram : Okay                          ║░░░
  50.           ║      Last error :                               ║░░░
  51.           ║    Total errors : 0                             ║░░░
  52.           ║      Total data : 12,799,872                    ║░░░
  53.           ║         Hang up : Okay                          ║░░░
  54.           ║     Delete name : Okay                          ║░░░
  55.           ╟─────────────────────────────────────────────────╢░░░
  56.           ║ Re:0000 Ab:004A Co:004F Tx:0FE1291A Rx:0FE11A9B ║░░░
  57.           ╚═════════════════════════════════════════════════╝░░░
  58.              ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                      - 1 -
  66.  
  67.                                                         TESTNET Page 2
  68.  
  69.  
  70.           You can also force a specifc device-driver to be called. You
  71.           put it's name on the command-line:
  72.  
  73.                 TESTNET COMM01  (Calls device COMM01)
  74.                 TESTNET COMM02  (Calls device COMM02)
  75.  
  76.           The following errors can be returned by TESTNET:
  77.  
  78.           Bad local session number:
  79.                 An error occurred within NetBIOS that forced the
  80.           termination of a session. No such information was reported
  81.           to TESTNET by NetBIOS so the very first indication that a
  82.           session had been aborted was when NetBIOS refused to accept
  83.           any more commands from the local session number.
  84.  
  85.           Can't cancel command:
  86.                 An attempt was made to cancel a command that had
  87.           either already completed or was not allowed to be canceled.
  88.           Because TESTNET only cancels one command (the CALL, if
  89.           COMM01 is busy), and since the cancel is legal, If you get
  90.           this error, your NetBIOS is returning errors not intended
  91.           for TESTNET.
  92.  
  93.           Can't find name:
  94.                 A CALL was made to a named device but there was no
  95.           response from the device. Either the device does not exist
  96.           or it was busy. This is normal if you don't have the MCOM
  97.           driver installed on a net-station somewhere on the local
  98.           network.
  99.  
  100.           Command canceled:
  101.                 A CANCEL command was executed successfully. This
  102.           should not appear because TESTNET does not issue any CANCEL
  103.           commands after a session has been established.
  104.  
  105.           Command not canceled:
  106.                 A CANCEL command failed to execute properly. TESTNET
  107.           does not issue any cancel commands after a session has been
  108.           established.
  109.  
  110.           Command timed out:
  111.                 A timeout on a RECEIVE or SEND command occurred. If a
  112.           timeout occurs during a send, the session is aborted. Time-
  113.           outs during receive are normal if there are no data being
  114.           received.
  115.  
  116.           Data error:
  117.                 The data received were not exactly the same as the
  118.           data sent.
  119.  
  120.           Duplicate name:
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                      - 2 -
  132.  
  133.                                                         TESTNET Page 3
  134.  
  135.                 An attempt was made to ADD NAME when the name was
  136.           already in use. Since TESTNET always uses a new unique-name
  137.           obtained by converting the system timer-tick into a hexa-
  138.           decimal character string, no duplicate names are possible
  139.           unless more than one copy of TESTNET is executing on the
  140.           network at one time.
  141.  
  142.           Illegal buffer length:
  143.                 The length of either an output or input buffer was too
  144.           long for the command. Since TESTNET always uses the correct
  145.           buffer-length which is fixed, not a variable, this error
  146.           should never occur.
  147.  
  148.           Illegal name-number:
  149.                 The session was aborted. The name-number no longer
  150.           exists. Something caused the session to be aborted. The fact
  151.           that the session had been aborted was not transmitted to
  152.           TESTNET so it continued to attempt to communicate with the
  153.           MCOM driver. The result was this error-code being returned.
  154.           A properly designed NetBIOS would inform a session that
  155.           communication has been lost so this error would never occur.
  156.  
  157.           Incompatible remote device
  158.                 Some hardware on the network is not responding cor-
  159.           rectly when addressed. This can be caused by noise on the
  160.           network.
  161.  
  162.           Interface busy:
  163.                 A SEND or RECEIVE command encountered a very busy
  164.           network. The commands will be retried.
  165.  
  166.           Invalid command:
  167.                 Some data-corruption has occurred, destroying the
  168.           network control-block. This is usually caused by a stack
  169.           overflow. Entering STACKS=15,255 in the CONFIG.SYS file may
  170.           help.
  171.  
  172.           Invalid NCB_LANA_NUM:
  173.                 Two NetBIOS programs are resident in memory. The wrong
  174.           one is being addressed. Check your network configuration.
  175.  
  176.           Local session table full:
  177.                 Two many sessions have already been started. There is
  178.           no more room. Reconfigure the network with more sessions
  179.           defined. This can also happen when NetBIOS pretends to
  180.           delete a name from the local name-table while in fact the
  181.           name remains, using a necessary slot.
  182.  
  183.           Locator not responding:
  184.                 The master station (if any) has gone off-line. If you
  185.           don't have a master-station the error-code probably means
  186.           that the CALLed name can't be located.
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                      - 3 -
  198.  
  199.                                                         TESTNET Page 4
  200.  
  201.  
  202.           Message incomplete:
  203.                 Data during a RECEIVE has been truncated because of a
  204.           buffer overflow. This can happen if the network is very busy
  205.           and the data-buffer length in the network configuration was
  206.           not correctly chosen. The buffer length is normally a
  207.           multiple of 1k (1024 bytes).
  208.  
  209.           Name conflict detected:
  210.                 An attempt was made to ADD NAME to the local session
  211.           table when the name was in use somewhere else on the net-
  212.           work. Since TESTNET guarantees a unique name, this should
  213.           never happen unless TESTNET is executing somewhere else on
  214.           the network.
  215.  
  216.           Name de-registered
  217.                 An attempt was name to DELETE NAME from the local
  218.           session table while a command was outstanding. When the
  219.           command completes, the same should be deleted. Experience
  220.           shows that the name will never be deleted and you will have
  221.           lost a slot in the name-table.
  222.  
  223.           Name deleted:
  224.                 A CALL or HANGUP command was made to a name that was
  225.           already deleted. This could happen if a net-station has gone
  226.           off-line forcing a session to be terminated.
  227.  
  228.           Name is in use:
  229.                 An attempt was made to ADD NAME to the local session
  230.           table when the name is in use locally.  Since TESTNET
  231.           guarantees a unique name, this should never happen unless
  232.           TESTNET is executing somewhere else on the network.
  233.  
  234.           Name not found:
  235.                 The CALLed name was not present probably because MCOM
  236.           was not loaded on a net-station.
  237.  
  238.           Name table full:
  239.                 No more slots are available in the local session
  240.           table. Reconfigure the network and then re-boot.
  241.  
  242.           NetBIOS not active:
  243.                 NetBIOS was not loaded or not responding.
  244.  
  245.           No resource available:
  246.                 Too many TSRs are using resources that are necessary
  247.           for the network to operate properly. Notice than some pro-
  248.           grams take-over the system's timer-interrupt and therefore
  249.           don't allow the network software to get any CPU time. Other
  250.           programs actually destroy any interrupt vectors that exist.
  251.           Such programs can't be used in a networking environment. To
  252.           find such programs, attempt to operate with no TSRs on the
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                      - 4 -
  264.  
  265.                                                         TESTNET Page 5
  266.  
  267.           net-station. Add each TSR until you find the one that des-
  268.           troys your system.
  269.  
  270.           Program is corrupt!
  271.                 The program file was damaged or changed. Obtain a new
  272.           copy from the distribution disk. If the program is altered
  273.           in any way this message will appear.
  274.  
  275.           Reserved name specified:
  276.                 Data corruption occurred causing the presence of
  277.           reserved characters "*" in the name-field.
  278.  
  279.           Session closed:
  280.                 An error occurred which forced the session to be
  281.           aborted.
  282.  
  283.           Session ended abnormally:
  284.                 An error occurred which forced the session to be
  285.           aborted. This usually occurs when the net-station executing
  286.           MCOM is rebooted when MCOM is in use.
  287.  
  288.           Session OPEN rejected:
  289.                 The CALLed name was found, but was busy.
  290.  
  291.           Stack overflow!
  292.                 There are too many TSRs using the user's stack during
  293.           interrupts. This causes the user's stack to grow too large.
  294.  
  295.           Too many commands:
  296.                 The NetBIOS in use was unable to queue more than one
  297.           command at a time. This is a very poor NetBIOS emulation.
  298.  
  299.           Undefined error:
  300.                 Something is getting corrupt which caused NetBIOS to
  301.           return an error-code that is undefined. This can be caused
  302.           by a stack overflow or a TSR that uses memory that doesn't
  303.           belong to it.
  304.  
  305.           The status line on the bottom shows the adapter status from
  306.           the remote net-station (the one you are communicating with).
  307.  
  308.           Re:0000 Ab:004A Co:004F Tx:0FE1291A Rx:0FE11A9B
  309.             |       |       |       |           |_ packets received
  310.             |       |       |       |_____________ packets transmitted
  311.             |       |       |_____________________ collisions
  312.             |       |_____________________________ datagram aborts
  313.             |_____________________________________ retransmits.
  314.  
  315.                 All numbers are hexadecimal.
  316.  
  317.           Running the program.
  318.           You can execute TESTNET overnight to see if there will be
  319.           any problems with aborted sessions. If you use UCOM to set
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                      - 5 -
  330.  
  331.                                                         TESTNET Page 6
  332.  
  333.           the baud-rate of the UART, you can send many millions of
  334.           bytes in an 8 hour period. At high baud-rates like 9600
  335.           baud, there may be a few data-errors, about one error for
  336.           every 64k of data. At low baud-rates, there won't be any
  337.           errors on a properly operating network. The data errors that
  338.           can occur result from missed hardware interrupts, not data-
  339.           corruption. If you have a fast machine or are using NetBIOS
  340.           software that does not disable interrupts for a long period
  341.           of time, the error-rate will be very low. Connecting a COM
  342.           port with hardware loop-back as is done for this test is a
  343.           worst-case situation because a byte is sent during an
  344.           interrupt-service routine then immediately received, gener-
  345.           ating another interrupt.
  346.  
  347.           - finis -
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                      - 6 -
  396.  
  397.